home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 8 / The Arsenal Files Collection #8 (Arsenal Computer) (1996).ISO / prg_gen / yg600w95.zip / YFIND.MAN < prev    next >
Text File  |  1996-11-17  |  3KB  |  94 lines
  1. YFind(1)                  User Commands                  YFind(1)
  2.  
  3.  
  4.  
  5.  NAME
  6.      YFind - search a file for a pattern
  7.  
  8.  SYNOPSIS
  9.       YFind [ -bchilnsvw[1-9] ]  regular-expression
  10.           [ filename ... ]
  11.  
  12.  
  13.  DESCRIPTION
  14.      The YFind command searches files for a  pattern  and  prints
  15.      all  lines  that  contain  that  pattern.
  16.  
  17.      Normally, each line found is copied to standard output.  The
  18.      file name is printed before each line found if there is more
  19.      than one input file.
  20.  
  21.      Filenames can be specified with MS-DOS  "wild chars" such as
  22.      * and ? (common in most MS-DOS applications for "any string"
  23.      and "any character").
  24.  
  25.  
  26.  OPTIONS
  27.      The following options are supported:
  28.  
  29.        -[1-9]       Do not  interpret  the pattern  as a  regular
  30.                     expression, but a plain text and allow 1 to 9
  31.             errors/approximations.
  32.  
  33.        -b           Precede each line  by  the  block  number  on
  34.                     which  it  was  found.  This can be useful in
  35.                     locating  block  numbers  by  context  (first
  36.                     block is 0, each block is 512 bytes long).
  37.  
  38.        -c           Print only a count of the lines that  contain
  39.                     the pattern.
  40.  
  41.        -f           Precede each line by the name of the file.
  42.  
  43.        -i           Ignore upper/lower  case  distinction  during
  44.                     comparisons.
  45.  
  46.        -n           Precede each line by its line number  in  the
  47.                     file (first line is 1).
  48.  
  49.        -s           Suppress error messages about nonexistent  or
  50.                     unreadable files
  51.  
  52.        -v           Print all lines except those that contain the
  53.                     pattern.
  54.  
  55.  
  56.  EXAMPLES
  57.      To find all uses of the word "Posix" (in any  case)  in  the
  58.      file  text.mm, and write with line numbers:
  59.  
  60.            example% YFind -i -n posix text.mm
  61.  
  62.      To find all empty lines in the standard input:
  63.  
  64.            example% YFind ^$
  65.      or
  66.            example% YFind -v .
  67.  
  68.      To find all uses of either "toto", "tota" or "toti"  in  the
  69.      file  text.mm, and write with line numbers:
  70.  
  71.            example% YFind -1 toto text.mm
  72.  
  73.  EXIT STATUS
  74.      The following exit values are returned:
  75.  
  76.        0            one or more matches were found
  77.  
  78.        1            no matches were found
  79.  
  80.        2            syntax errors or inaccessible files (even  if
  81.                     matches were found).
  82.  
  83.  NOTES
  84.      Lines  are  limited  to  1024  characters; longer  lines  are
  85.      truncated.
  86.  
  87.      YFind  does not  use the  Soundex  algorithm  provided by the
  88.      YGrep Search  Engine.  It is  limited  to  approximative  and
  89.      regular expression searches.
  90.  
  91.  INSTALLATION
  92.      YFind is to be installed in the same directory as YGrep32.DLL
  93.      in order to  find it when needed for operation.  The simplest
  94.      location is certainly the C:\WINDOWS directory.